home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Graphics Plus
/
Graphics Plus.iso
/
msdos
/
plotting
/
ezgraph
/
ezgread.me
< prev
next >
Wrap
Text File
|
1989-12-31
|
34KB
|
925 lines
=================================================================
EZGraph Notes
=================================================================
Copyright PM Enterprises 1990. All Rights Reserved.
---------------------------------------------------
PM Enterprises
2315 El Paseo
Las Cruces, NM 88001
--------------------
A few excerpts from the EZGraph user manual are provided
here. These notes will enable you to get EZGraph up and running.
PM Enterprises appreciates you taking the time to evaluate
our product. We feel confident that you will find EZGraph very
easy to use and quite robust.
Don't forget, upon reciept of your registration fee we will
rush you a printed user manual. This manual will fully explain
the various features of EZGraph and show you how to use the
options to create many different types of graphs. In addition you
will be provided with a telephone number that can be used to
receive customer support.
Copyright 1990 by PM Enterprises
=================================================================
Introduction
=================================================================
EZGraph creates 2 dimensional scientific type graphs from
simple ASCII data files. EZGraph has many features and options
that allow you to customize almost every aspect of a graph.
Nevertheless, all the features in the world are useless if you
can't use them or if you don't know what affect they might have.
This is why EZGraph was designed with pull-down menus and a
WYSIWYG (What You See Is What You Get) display that provides
instant feedback about the decisions you make.
The EZGraph menu system provides two different ways to work
with the program. Menu items can be selected with the keyboard or
you can use a Microsoft compatible mouse. Most of the options in
EZGraph can be changed with the mouse alone, hence our products
slogan: "Scientific Line Graphs At The Tip Of Your Finger".
Regardless, not all operations can be performed with a mouse, you
just can't beat an old fashioned keyboard for things like text
and numeric entry.
EZGraph allows you to create both line and bar type graphs.
With the line graphs you have several different choices of line
type including thick lines and symbols. Bar graphs can be
customized with different bar styles and can be used in
conjunction with line graphs. EZGraph can plot up to five data
sets in a graph. A data set is an ASCII file that can contain an
(almost) unlimited number of X,Y data pairs arranged in a column
format. Each data set is independent and can have it's own line
type and line color.
EZGraph provides a tremendous amount of control over the
graph design. You have complete control over the axis scaling,
the number and type of graph grid lines, the position of each
axis, even the decimal format of the axis grid labels. Each axis
of the graph can be plotted with a linear or a logarithmic scale.
You can place an axis title on each of the four graph borders.
You can set up a graph legend that automatically updates itself.
You can place text anywhere on the graph with the freehand
annotation feature and you can add lines and boxes to the graph.
Large blocks of text can be placed on the graph with the text
block function. All of the text placed on a graph may contain
super and sub-scripts.
Because EZGraph deals only with the vectors required to draw
a graph, a graph and all of the annotation can be thought of as a
unit. The actual size of this unit is defined by the physical
corners on the page (screen) and the graph is always drawn
relative to the four physical corners. Using the cursor you can
set the physical corners of the graph anywhere on the page.
Changing the size of the graph has no effect on the internal
appearance of the graph unit, all of the relationships are
maintained. The graph simply appears smaller or bigger. This
Copyright 1990 by PM Enterprises
capability allows you to place a graph of any size anywhere on
the page and makes it possible to put as many graphs as you want
on a page.
After you have designed your graph and are content with its
appearance, you can save all of the graph parameters in a format
file. A format file is like a recipe in that it contains all of
the information necessary for EZGraph to reproduce your graph.
You may have tried the demos that came with EZGraph, these demos
are created from a format file.
EZGraph will also allow you to save an entire image of the
screen to disk. Visual slide shows can be created by saving
screen images for later playback. Your registration kit includes
a new program called EZGShow. You can use this program to set up
custom slide shows that run automatically.
EZGraph can dump screen images to a printer or it can
reproduce your graph exactly on a HPGL graphics plotter. Screen
dumps are supported for standard 9-pin, 24-pin, and laserjet
printers. EZGraph uses simple bit-mapped techniques to send the
printer an image of the screen. This leads to the problem of
hardware dependent resolution and less than optimal graphs.
If you need higher quality then you can use the vector-based
HPGL plotter output to create presentation quality graphs.
EZGraph supports any HPGL device that is compatible with the 7470
series of Hewlett Packard plotters. In addition, there are
currently several products available that will allow you to
produce high quality HPGL output on both dot-matrix and laserjet
printers.
It should also be mentioned that most modern desktop
publishing programs like Ventura Publisher and PageMaker will
accept HPGL files, which means you can import your EZGraph plots
directly into a document.
EZGraph uses simple ASCII data files that can come from many
sources. The data files are column based and easy to work with.
You may have some sort of experimental data that you have
collected on your own, in this situation you can use a text
editor or word processor to enter the data directly into an ASCII
file.
Perhaps you have written a BASIC or FORTRAN program that
generates data, in this case you can have your program output the
results to a file.
If you are using a spreadsheet, all you need to do is save
the appropriate columns of data in an ASCII file.
EZGraph includes a run-time function generator that can be
used to evaluate simple or complex mathematical formulas. Suppose
Copyright 1990 by PM Enterprises
you have a math function and you would like to see what kind of a
curve the formula generates. You can use EZGraph to evaluate the
function over a finite interval and generate a data file with the
results.
And finally, EZGraph is capable of performing some very
useful tasks like curve fitting and smoothing. The data
manipulation routines that EZraph provides are normally found
only in programs costing hundreds of dollars.
=================================================================
Getting Started
=================================================================
** Hardware Requirements...
EZGraph requires an IBM compatible PC or AT computer with
graphics capabilities. The computer will need at least 512K of
memory and if present, EZGraph will utilize a math co-processor.
EZGraph supports the four major IBM video standards; MGA
(Hercules), CGA, EGA, and VGA. EZGraph uses DOS function calls to
drive the graphics equipment, therefore it is important that your
video adapter be sufficiently compatible.
EZGraph can be used with dual floppy disks or a hard disk.
EZGraph will work with any Microsoft compatible mouse or
trackball.
EZGraph can send screen dumps to any Epson compatible 9-pin
or 24-pin dot matrix printer as well as Hewlett Packard
compatible laserjet printers.
EZGraph generates plotter data that can be used by any
plotter or plotter emulation program that accepts the standard
HPGL graphics language.
** Setting up EZGraph...
Before you do anything you should make back-up copies of
your original EZGraph diskettes. If your not sure how to do this
refer to the DISKCOPY command in your DOS manual. If you are
going to use EZGraph on a dual-floppy PC you will need to set up
three disks, a working disk for the EZGraph program, one for the
auxiliary programs and another to store data files.
If you are going to use EZGraph on a hard disk then you
should create a directory for EZGraph and a directory for your
data files. If your not sure how to do this refer to the MKDIR
and CHDIR commands in your DOS manual. Once you have an EZGraph
directory, for example C:\EZGRAPH, copy all of the files on your
original EZGraph diskettes into this directory.
Copyright 1990 by PM Enterprises
EXAMPLE: C:\MKDIR EZGRAPH
C:\CHDIR EZGRAPH
C:\EZGRAPH COPY A:*.*
To run the program, make sure you are in the EZGraph
directory and type EZG at the DOS prompt.
** Running EZGraph on a MonoGraphics system...
If your computer has a monographic (MGA or Hercules) video
adapter you need to take a special step before starting EZGraph;
you must load the driver program called EZGherc. EZGherc is a
special driver program that enables EZGraph to use your
monographics video card, without it, EZGraph simply won't work.
The best thing to do is use a batch file to make sure
EZGherc gets loaded each time you run EZGraph. Just such a batch
file has been provided for you in the distribution diskette, it
is called EZGh.BAT.
To start EZGraph on a monographic system type EZGH at the
DOS prompt.
** Running EZGsetup...
Before you begin you should configure EZGraph for your
particular computer by running the EZGSetup program.
EZGSetup creates a file named EZG.CFG that contains
information about your EZGraph configuration. Each time you
install EZGraph on a new computer, or EZG.CFG gets deleted, you
should run EZGSetup. If you want, you can keep different copies
of EZG.CFG and use batch files to select the appropriate copy for
different tasks.
EZGSetup is located on the auxiliary disk, to start the
program type EZGSetup at the DOS prompt. If you are working on a
dual floppy system, put your EZGraph working disk in drive A: and
your auxiliary disk in drive B:. At the A: prompt type
B:EZGSetup. This will ensure that EZG.CFG ends up on the EZGraph
disk.
When you run EZGsetup you will be asked several different
questions. To select an item on the menu, use the cursor bar to
highlight your choice and then press return.
EZGsetup will want to know which type of printer you are
using. You may choose between a 9-pin, 24-pin, and a laserjet
printer. If your not sure which type of dot-matrix printer you
have there is a simple rule of thumb; If your printer outputs NLQ
(Near Letter Quality) then you have a 9-pin printer, if your
printer outputs LQ (Letter Quality) then you have a 24-pin
printer. Some 9-pin printers are the EPSON FX and IBM ProPrinter.
Some 24-pin printers are the EPSON LQ and NEC PinWriter. If you
Copyright 1990 by PM Enterprises
select a 24-pin printer and it doesn't work then run EZGsetup
again and select a 9-pin printer.
You will be asked which port your printer is connected to,
either LPT1 pr LPT2. If your not sure just make a guess, most
probably your printer is connected to LPT1. You can run the
EZGsetup again if your guess is wrong.
EZGsetup will ask you to select one of 7 available startup
graphics modes: You may select any video mode that your hardware
supports. Don't worry If you select a video mode that is not
supported by your hardware, EZGraph will automatically default to
the highest resolution video mode that your hardware can display.
If you are going to be using a plotter with EZGraph, you
will need to select the serial port and baud rate that your
plotter is using. You will need to know which serial port you are
using, COM1 or COM2. Again if your not sure just guess, you can
come back later and select the other port if your guess is wrong.
As for the baud rate that your plotter is using, if your not
sure then you will need to check the documentation that came with
your plotter. Make sure you get this right as EZGraph won't plot
a thing if the baud rate is wrong. The serial communication
parameters that EZGraph uses are no parity, 8 data bits, and 1
stop bit. Almost all plotters uses these parameters as their
default settings, if your having trouble with your plotter
connection you might want to double check that the plotter is in
fact set up with these parameters.
If your not using a plotter then just select anything at
these prompts, it doesn't matter.
Finally, you will need to tell EZGraph which plotter pens to
associate with the 16 colors that your computer screen can
display. HPGL compatible plotters have anywhere from 1 to 8 pens.
Consult your plotter documentation if your not sure how your
plotter numbers the pens.
The information you will be providing will tell EZGraph
which pen to select when it is drawing something with a
particular color. If your not going to do any plotting just keep
pressing return until you have answered the 16 prompts. If you
intend to use a plotter, take some time to develop a strategy for
using your different color plotter pens.
Feel free to select the same pen to use with different
screen colors. Note that if you are using EZGraph on a MGA or CGA
monitor, the only screen colors are 0 and 1, so the only plotter
pens that will ever be selected are the ones you choose for these
two colors.
Copyright 1990 by PM Enterprises
** Using a mouse...
If you are going to use a Microsoft compatible mouse with
EZGraph, you need to do a few things before you start. Most
mouses (mice ?) utilize a special mouse driver program. Typically
you will load this driver either in your CONFIG.SYS file or in
your AUTOEXEC.BAT file.
EZGraph uses the mouse driver and if you have not loaded it
prior to running EZGraph, the mouse won't work. If your not sure
how to load the mouse driver please check the documentation that
came with your mouse, it will explain what you need to do.
** Using the keyboard...
Although EZGraph works best with a mouse, you don't have to
have one to use the program. You can use the keyboard cursor keys
instead.
If you have an enhanced keyboard you can use either set of
cursor keys, if you are using the cursor keys on the numeric
keypad, make sure the NumLock is off. The F1 and F2 keys on your
keyboard act like the left and right mouse buttons on a mouse.
Whenever you are at a place in the program that requires
pressing the left or right mouse button, you can press the F1 or
F2 key instead, respectively. Remember this while reading the
manual and whenever you see the phrase "press the left/right
mouse button" you can replace it with "press the F1/F2 key".
One of the nicest things about a mouse is that you can move
the cursor very rapidly. In an attempt to match this performance
with the cursor keys, EZGraph keeps track of how long you have
held a cursor key down.
If you hold a cursor key down for more than a brief moment
the cursor begins to "accelerate", taking bigger and bigger
steps. After you release the cursor key EZGraph will wait a few
seconds and then slow the cursor back down to the slowest speed.
If your trying to position the cursor and it is taking steps
that are to big, tap the spacebar; this will slow the cursor down
immediately.
If you are running EZGraph on an AT computer, see the
discussion on "improving keyboard cursor speed" in the tips and
techniques section on how to speed up your cursor.
** Operating the menu...
When you start EZGraph you will see a menu across the top of
the screen. Just to the right of the menu is a display that
indicates the position of the cursor. In the upper right hand of
the screen is the help button.
Copyright 1990 by PM Enterprises
You will notice that each menu item has one character in
uppercase, this is called the "key" character. On color monitors
the key character will also appear in a different color. You can
select a menu item by pressing its respective key character.
Alternately, you can move the cursor to the menu area of
the screen and a highlight bar will appear. The highlight bar
will follow the cursor. By pressing the left mouse button you
will select the currently highlighted menu item.
All of the EZGraph menus follow this convention; press the
key character or use the cursor to highlight the menu item.
When you select a menu item from the main menu you will see
a sub-menu drop down. Again you can use the methods discussed
above to select a menu item. If you want to make the drop down
menu go away, press the ESC key or move the cursor outside of the
menu area and press the left mouse button.
Whenever you are using the EZGraph command system, you can
always back up without making any changes by pressing the ESC
key. You can also back out of menus by moving the cursor out of
the menu area and pressing the left mouse button.
EZGraph has an on line help facility that will give you a
brief description of the various menu commands. Whenever the help
facility is available you will see the help button in the upper
left hand corner of the screen.
You may activate the help by pressing the F10 key or by
moving the cursor onto the help button area and pressing the left
mouse button. After you have read the help message you can return
to the menu by pressing any key.
=================================================================
EZGraph Data Files
=================================================================
** The format of a regular data file is:
X1 Y1 S1
X2 Y2 S2
. . .
. . .
Xn Yn Sn
Where Xn is the nth X coordinate, Yn is the nth Y
coordinate, and the optional Sn is the standard deviation of the
Y coordinate. If error bars are selected the length of the error
bar will be 2Sn.
The only rule regarding the placement of numbers in a
regular data file is that the numbers be separated by at least
Copyright 1990 by PM Enterprises
one space.
** The format of a bar graph data file is:
YMIN1 YMAX1 LABEL1
YMIN2 YMAX2 LABEL2
. . .
. . .
YMINn YMAXn LABELn
Where YMINn is the minimum Y coordinate of bar n, YMAXn is
the maximum Y coordinate of bar n, and LABELn is the label that
will be placed directly underneath bar n.
The only rule regarding the placement of data in a bar graph
data file is that the numbers and labels be separated by at least
one space.
** Comments is data files...
You may include comments in your data files. Any line that
begins with a semicolon ";", will be treated as a comment. It is
a good idea to put comments in your data files noting where the
data came from.
=================================================================
Sample Session
=================================================================
** Creating a line graph...
The first thing you must do is create some data files. For
the purpose of this example we will assume that you are creating
the data files in the same directory as the EZGraph program. Use
a text editor or a word processor to enter the following data and
create a file named MCELLS.DAT:
;Example data file MCells.Dat
;
2 10 3
5 16 4
10 28 6
18 39 7
32 47 8
64 64 9
;End
Now create another data file named PCELLS.DAT by entering
the following data into the file:
Copyright 1990 by PM Enterprises
;Example data file PCells.dat.
;
2 1 2
5 2 2
10 3 3
18 5 4
32 9 6
64 12 8
;End
Now start up EZGraph by typing EZG at the DOS prompt.
Select the File sub-menu.
Select file-1: enter "MCELLS.DAT"
Select file-2: enter "PCELLS.DAT"
Press ESC and Select the Data sub-menu.
Select Clear scrn.
Select the Data sub-menu again.
Select Plot now, EZGraph will re-draw the screen.
Select the Size sub-menu.
Select Axis endpts.
Select the X-axis.
Enter 0 for the min coordinate and 80 for the max
coordinate.
Select Axis endpts.
Select the Y-axis.
Enter 0 for the min coordinate and 80 for the max
coordinate.
Press ESC and select the Grids sub-menu.
Select X axis grids and enter 8 major grids and 1 minor
grid.
Select Y axis grids and enter 8 major grids and 1 minor
grid.
Press ESC and select the Text sub-menu.
Select axis Titles.
Select the Bottom title and enter: Contrast (%)
Select axis Titles.
Select the Left title and enter: Response (ips)
Press ESC and Select the Data sub-menu.
Select Clear scrn.
Select the Data sub-menu again.
Select Plot now, EZGraph will plot the two data files.
You now have a simple line graph displayed on the page. If
you like you can continue to experiment with the different graph
parameters.
** Creating a bar graph...
Use a text editor or a word processor to enter the following
data and create a file named BULBS.DAT:
Copyright 1990 by PM Enterprises
;Example file BULBS.DAT.
;
0 20 5
0 50 6
0 120 7
0 250 8
0 580 9
0 410 10
0 430 11
0 70 12
0 60 13
0 10 14
;End
Now start up EZGraph by typing EZG at the DOS prompt.
Select the File sub-menu.
Select file-1: enter "BULBS.DAT"
Press ESC and Select the Data sub-menu.
Select Line type.
Select Bar and press Enter at the next prompt.
Select Crss.
Select Clear scrn.
Select the Data sub-menu again.
Select Plot now, EZGraph will draw the bar graph.
Select the Size sub-menu.
Select Axis endpts.
Select the Y-axis.
Enter 0 for the min coordinate and 1000 for the max
coordinate.
Press ESC and Select the Text sub-menu.
Select axis Titles.
Select the Bottom title and enter: LifeTime In Hours
Select axis Titles.
Select the Left title and enter: Frequency
Press ESC and Select the Data sub-menu.
Select Clear scrn.
Select the Data sub-menu again.
Select Plot now, EZGraph will plot the two data files.
You now have a bar graph displayed on the page. If you like
you can continue to experiment with the different graph
parameters.
=================================================================
Tips And Techniques
=================================================================
** Improving keyboard cursor speed...
If you are using an AT class computer and you don't have a
mouse, you may use the supplied program named FASTKEY to speed up
the keyboard cursor keys. Simply run FASTKEY before you start
EZGraph, in fact you may want to have your AUTOEXEC.BAT file run
Copyright 1990 by PM Enterprises
FASTKEY every time you start your computer.
** Improving performance with a cache or a RAM-disk...
If you are working with large data files and are finding
that EZGraph takes to long to re-draw the graph, you should
consider using a disk-cache or a RAM-disk.
If you use a hard-disk cache, the computer will usually be
able to find the data that EZGraph needs in the cache.
If you don't have a cache program you may want to use a
RAM-Disk similar to the DOS VDISK program. Before starting
EZGraph, copy your data files into the RAM-Disk. Before you turn
your computer off don't forget to copy the modified RAM-Disk data
files back on to a floppy or hard disk.
** Overlaying line plots on bar graphs...
It is possible to superimpose line plots over bar graphs.
Each bar is located with an X coordinate evenly divisible by
10. For example, in a bar graph with 4 bars the first bar will be
centered about 10, the second bar at 20, the third at 30 and the
fourth at 40. In this example the auto-scale function would set
the X-axis endpoints at 5 and 45.
The Y-axis coordinates are determined by the actual height
of the bars.
To place a line plot over the bar graph, create a regular
data file with the proper values to fall within the endpoints
determined by the bar graph (the normalize routine may be useful
to transform a data file into a range compatible with the bar
graph).
** Batch processing with format files...
If you create a graph format file by using the save format
command, you can give the name of this file on the EZGraph
command line and EZGraph will immediately load the format and
display the graph.
The last line of the format file contains a NOP command. You
can use an editor to replace this NOP command with a PRINT or
PLOT command. This will cause EZGraph to perform the indicated
operation when the format file is passed in on the command line.
After the graph is plotted or printed, EZGraph will quit and
return to DOS.
** Batch plotting HPGL files...
If you use EZGraph to send HPGL plotter data to a disk file,
you can plot this file at a later date without using EZGraph.
Copyright 1990 by PM Enterprises
You will need to use the DOS MODE and COPY commands to do
this. If you are not familiar with the MODE command refer to your
DOS documentation.
As an example, suppose your plotter is connected to COM1:
and is running at 2400 Baud and your data file is named
PLOTTER.DAT and is located in the current directory. The
following commands will do the trick:
MODE COM1:2400,N,8,1
COPY PLOTTER.DAT COM1:
=================================================================
Using EZGShow
=================================================================
EZGShow is a program that allows you to create, edit, and
maintain screen image slide shows. You can use the program with
screen images that EZGraph has stored to disk. EZGShow can
display each screen in the slide show for a predetermined amount
of time or it can wait for a keypress after an image is loaded.
EZGShow is located on the auxiliary disk, to start the
program type EZGShow at the DOS prompt.
When the program is started you will be asked if you want to
run, create, or edit a slide show.
Before you can run a slide show must create a slide show
file. A slide show file contains a list of screen image filenames
and time delay values to determine how long the images will be
displayed. Each slide show file can hold up to 100 screen image
filenames.
When you choose to create a slide show you will be asked to
provide a valid DOS filename for the slide show file.
You will then go into slide show edit mode. You will see a
list of slide show slots. In the list you will see a column for a
screen image filename, a column labeled PT, and a column labeled
PK. The PT stands for "Pause Time" and the PK stands for "Press
Key". If the pause time is 0 there will be an X in the PK column,
indicating that the image will be displayed until a key is
pressed.
In edit mode you can enter a screen image filename into any
of the 100 slots. Use the cursor keys, the Page-Up, and the
Page-Down keys to highlight the image slot you wish to edit, then
press return.
When you have selected a file position you will be asked to
enter a valid DOS filename for the screen image. You will then be
asked to enter the pause time for the image. You may enter the
Copyright 1990 by PM Enterprises
number of seconds you wish to have the image displayed. If you
enter 0 then the image will be displayed until a key is pressed.
When you are done editing the slide show press ESC to return
to the main menu.
If you choose to edit a slide show from the main menu the
procedure will be just like creating a slide show. The difference
is that you will be prompted for the old slide show filename
instead of a new filename.
When you run a slide show you will be asked for the slide
show filename. As soon as you have entered the filename the slide
show will begin. EZGShow will display each file that it finds in
the slide show and either pause for the requested time or wait
for a keypress. Press the ESC key at any time to abort the slide
show and return to the main menu.
If a screen image has been displayed and EZGShow is waiting
for a keypress, you can press the F1 key to have the screen
printed.
You can pass the name of a slide show file on the EZGShow
command line and EZGShow will automatically start running the
slide show.
When displaying screen images, EZGShow will use the video
mode that it finds in the EZG.CFG file. You must make sure that
the screen images you are loading were created in the same video
mode that you select with EZGSetup.
Copyright 1990 by PM Enterprises